Decoradores TypeScript: Dominando Padrões de Programação com Metadados para Aplicações Robustas

            @MeuDecorador
class MinhaClasse {
  @OutroDecorador
  meuMetodo() {
    // ...
  }
}
            

              
                Copy
              
            
          

            // tsconfig.json
{
  "compilerOptions": {
    "target": "ES2017",
    "module": "commonjs",
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    "outDir": "./dist",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  }
}
            

              
                Copy
              
            
          

            npm install reflect-metadata --save
# ou
yarn add reflect-metadata
            

              
                Copy
              
            
          

            import "reflect-metadata";
// O código da sua aplicação segue
            

              
                Copy
              
            
          

            function Logger(prefix: string) {
  return function (target: Function) {
    console.log(`[${prefix}] Classe ${target.name} foi definida.`);
  };
}

@Logger("APP_INIT")
class ApplicationBootstrap {
  constructor() {
    console.log("Aplicação iniciando...");
  }
}

const app = new ApplicationBootstrap();
// Saída:
// [APP_INIT] Classe ApplicationBootstrap foi definida.
// Aplicação iniciando...

            

              
                Copy
              
            
          

            function DecoradorDeClasse(target: Function) { ... }
            

              
                Copy
              
            
          

            const InjectableServiceRegistry = new Map<string, Function>();

function Injectable(name?: string) {
  return function<T extends { new(...args: any[]): {} }>(constructor: T) {
    const serviceName = name || constructor.name;
    InjectableServiceRegistry.set(serviceName, constructor);
    console.log(`Serviço registrado: ${serviceName}`);

    // Opcionalmente, você poderia retornar uma nova classe aqui para aumentar o comportamento
    return class extends constructor {
      createdAt = new Date();
      // Propriedades ou métodos adicionais para todos os serviços injetados
    };
  };
}

@Injectable("UserService")
class UserDataService {
  getUsers() {
    return [{ id: 1, name: "Alice" }, { id: 2, name: "Bob" }];
  }
}

@Injectable()
class ProductDataService {
  getProducts() {
    return [{ id: 101, name: "Laptop" }, { id: 102, name: "Mouse" }];
  }
}

console.log("--- Serviços Registrados ---");
console.log(Array.from(InjectableServiceRegistry.keys()));

const userServiceConstructor = InjectableServiceRegistry.get("UserService");
if (userServiceConstructor) {
  const userServiceInstance = new userServiceConstructor();
  console.log("Usuários:", userServiceInstance.getUsers());
  // console.log("UserService Created At:", userServiceInstance.createdAt); // Se a classe retornada for usada
}
            

              
                Copy
              
            
          

            function DecoradorDeMetodo(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) { ... }
            

              
                Copy
              
            
          

            function MeasurePerformance(target: Object, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalMethod = descriptor.value;

  descriptor.value = function(...args: any[]) {
    const start = process.hrtime.bigint();
    const result = originalMethod.apply(this, args);
    const end = process.hrtime.bigint();
    const duration = Number(end - start) / 1_000_000;
    console.log(`Método "${propertyKey}" executado em ${duration.toFixed(2)} ms`);
    return result;
  };

  return descriptor;
}

class DataProcessor {
  @MeasurePerformance
  processData(data: number[]): number[] {
    // Simula uma operação complexa e demorada
    for (let i = 0; i < 1_000_000; i++) {
      Math.sin(i);
    }
    return data.map(n => n * 2);
  }

  @MeasurePerformance
  fetchRemoteData(id: string): Promise<string> {
    return new Promise(resolve => {
      setTimeout(() => {
        resolve(`Dados para ID: ${id}`);
      }, 500);
    });
  }
}

const processor = new DataProcessor();
processor.processData([1, 2, 3]);
processor.fetchRemoteData("abc").then(result => console.log(result));
            

              
                Copy
              
            
          

            function DecoradorDeAcessador(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) { ... }
            

              
                Copy
              
            
          

            function CachedGetter(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalGetter = descriptor.get;
  const cacheKey = `_cached_${String(propertyKey)}`;

  if (originalGetter) {
    descriptor.get = function() {
      if (this[cacheKey] === undefined) {
        console.log(`[Cache Miss] Calculando valor para ${String(propertyKey)}`);
        this[cacheKey] = originalGetter.apply(this);
      } else {
        console.log(`[Cache Hit] Usando valor em cache para ${String(propertyKey)}`);
      }
      return this[cacheKey];
    };
  }
  return descriptor;
}

class ReportGenerator {
  private data: number[];

  constructor(data: number[]) {
    this.data = data;
  }

  // Simula uma computação cara
  @CachedGetter
  get expensiveSummary(): number {
    console.log("Executando cálculo de resumo caro...");
    return this.data.reduce((sum, current) => sum + current, 0) / this.data.length;
  }
}

const generator = new ReportGenerator([10, 20, 30, 40, 50]);

console.log("Primeiro acesso:", generator.expensiveSummary);
console.log("Segundo acesso:", generator.expensiveSummary);
console.log("Terceiro acesso:", generator.expensiveSummary);
            

              
                Copy
              
            
          

            function DecoradorDePropriedade(target: Object, propertyKey: string | symbol) { ... }
            

              
                Copy
              
            
          

            interface ValidationRule {
  property: string | symbol;
  validate: (value: any) => boolean;
  message: string;
}

const validationRules: Map<Function, ValidationRule[]> = new Map();

function Required(target: Object, propertyKey: string | symbol) {
  const rules = validationRules.get(target.constructor) || [];
  rules.push({
    property: propertyKey,
    validate: (value: any) => value !== null && value !== undefined && value !== "",
    message: `${String(propertyKey)} é obrigatório.`
  });
  validationRules.set(target.constructor, rules);
}

function validate(instance: any): string[] {
  const classRules = validationRules.get(instance.constructor) || [];
  const errors: string[] = [];

  for (const rule of classRules) {
    if (!rule.validate(instance[rule.property])) {
      errors.push(rule.message);
    }
  }
  return errors;
}

class UserProfile {
  @Required
  firstName: string;

  @Required
  lastName: string;

  age?: number;

  constructor(firstName: string, lastName: string, age?: number) {
    this.firstName = firstName;
    this.lastName = lastName;
    this.age = age;
  }
}

const user1 = new UserProfile("John", "Doe", 30);
console.log("Validação do Usuário 1 erros:", validate(user1)); // []

const user2 = new UserProfile("", "Smith");
console.log("Validação do Usuário 2 erros:", validate(user2)); // ["firstName é obrigatório."]

const user3 = new UserProfile("Alice", "");
console.log("Validação do Usuário 3 erros:", validate(user3)); // ["lastName é obrigatório."]
            

              
                Copy
              
            
          

            function DecoradorDeParametro(target: Object, propertyKey: string | symbol | undefined, parameterIndex: number) { ... }
            

              
                Copy
              
            
          

            interface ParameterMetadata {
  index: number;
  key: string | symbol;
  resolver: (request: any) => any;
}

const parameterResolvers: Map<Function, Map<string | symbol, ParameterMetadata[]>> = new Map();

function RequestParam(paramName: string) {
  return function (target: Object, propertyKey: string | symbol | undefined, parameterIndex: number) {
    const targetKey = propertyKey || "constructor";
    let methodResolvers = parameterResolvers.get(target.constructor);
    if (!methodResolvers) {
      methodResolvers = new Map();
      parameterResolvers.set(target.constructor, methodResolvers);
    }
    const paramMetadata = methodResolvers.get(targetKey) || [];
    paramMetadata.push({
      index: parameterIndex,
      key: targetKey,
      resolver: (request: any) => request[paramName]
    });
    methodResolvers.set(targetKey, paramMetadata);
  };
}

// Uma função hipotética do framework para invocar um método com parâmetros resolvidos
function executeWithParams(instance: any, methodName: string, request: any) {
  const classResolvers = parameterResolvers.get(instance.constructor);
  if (!classResolvers) {
    return (instance[methodName] as Function).apply(instance, []);
  }
  const methodParamMetadata = classResolvers.get(methodName);
  if (!methodParamMetadata) {
    return (instance[methodName] as Function).apply(instance, []);
  }

  const args: any[] = Array(methodParamMetadata.length);
  for (const meta of methodParamMetadata) {
    args[meta.index] = meta.resolver(request);
  }
  return (instance[methodName] as Function).apply(instance, args);
}

class UserController {
  getUser(@RequestParam("id") userId: string, @RequestParam("token") authToken?: string) {
    console.log(`Buscando usuário com ID: ${userId}, Token: ${authToken || "N/A"}`);
    return { id: userId, name: "Jane Doe" };
  }

  deleteUser(@RequestParam("id") userId: string) {
    console.log(`Excluindo usuário com ID: ${userId}`);
    return { status: "deleted", id: userId };
  }
}

const userController = new UserController();

// Simula uma requisição recebida
const mockRequest = {
  id: "user123",
  token: "abc-123",
  someOtherProp: "xyz"
};

console.log("\n--- Executando getUser ---");
executeWithParams(userController, "getUser", mockRequest);

console.log("\n--- Executando deleteUser ---");
executeWithParams(userController, "deleteUser", { id: "user456" });
            

              
                Copy
              
            
          

            @DecoradorA
@DecoradorB
class MinhaClasse {
  // ...
}

            

              
                Copy
              
            
          

            function LogCall(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalMethod = descriptor.value;
  descriptor.value = function (...args: any[]) {
    console.log(`[LOG] Chamando ${String(propertyKey)} com args:`, args);
    const result = originalMethod.apply(this, args);
    console.log(`[LOG] Método ${String(propertyKey)} retornou:`, result);
    return result;
  };
  return descriptor;
}

function Authorization(roles: string[]) {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    const originalMethod = descriptor.value;
    descriptor.value = function (...args: any[]) {
      const currentUserRoles = ["admin"]; // Simula a busca de roles do usuário atual
      const authorized = roles.some(role => currentUserRoles.includes(role));
      if (!authorized) {
        console.warn(`[AUTH] Acesso negado para ${String(propertyKey)}. Roles necessários: ${roles.join(", ")}`);
        throw new Error("Acesso não autorizado");
      }
      console.log(`[AUTH] Acesso concedido para ${String(propertyKey)}`);
      return originalMethod.apply(this, args);
    };
    return descriptor;
  };
}

class SecureService {
  @LogCall
  @Authorization(["admin"])
  deleteSensitiveData(id: string) {
    console.log(`Excluindo dados sensíveis para ID: ${id}`);
    return `Dados ID ${id} excluídos.`;
  }

  @Authorization(["user"])
  @LogCall // Ordem alterada aqui
  fetchPublicData(query: string) {
    console.log(`Buscando dados públicos com query: ${query}`);
    return `Dados públicos para query: ${query}`; 
  }
}

const service = new SecureService();

try {
  console.log("\n--- Chamando deleteSensitiveData (Usuário Admin) ---");
  service.deleteSensitiveData("record123");
} catch (error: any) {
  console.error(error.message);
}

try {
  console.log("\n--- Chamando fetchPublicData (Usuário Não-Admin) ---");
  // Simula um usuário não-admin tentando acessar fetchPublicData, que requer o role 'user'
  const mockUserRoles = ["guest"]; // Isso falhará na autorização
  // Para tornar isso dinâmico, você precisaria de um sistema de DI ou contexto estático para os roles do usuário atual.
  // Para simplificar, assumimos que o decorador Authorization tem acesso ao contexto do usuário atual.
  // Vamos ajustar o decorador Authorization para sempre assumir 'admin' para fins de demonstração, 
  // então a primeira chamada terá sucesso e a segunda falhará para mostrar caminhos diferentes.
  
  // Re-executar com role de usuário para fetchPublicData ter sucesso.
  // Imagine que currentUserRoles em Authorization se torna: ['user']
  // Para este exemplo, vamos mantê-lo simples e mostrar o efeito da ordem.
  service.fetchPublicData("search term"); // Isso executará Auth -> Log
} catch (error: any) {
  console.error(error.message);
}

/* Saída esperada para deleteSensitiveData:
[AUTH] Acesso concedido para deleteSensitiveData
[LOG] Chamando deleteSensitiveData com args: [ 'record123' ]
Excluindo dados sensíveis para ID: record123
[LOG] Método deleteSensitiveData retornou: Dados ID record123 excluídos.
*/

/* Saída esperada para fetchPublicData (se o usuário tiver o role 'user'):
[LOG] Chamando fetchPublicData com args: [ 'search term' ]
[AUTH] Acesso concedido para fetchPublicData
Buscando dados públicos com query: search term
[LOG] Método fetchPublicData retornou: Dados públicos para query: search term
*/
            

              
                Copy
              
            
          

            function log(message: string) {
  return function (target: any, propertyKey: string | symbol | undefined, descriptorOrIndex?: PropertyDescriptor | number) {
    if (typeof descriptorOrIndex === 'number') {
      console.log(`Decorador de Parâmetro: ${message} no parâmetro #${descriptorOrIndex} de ${String(propertyKey || "constructor")}`);
    } else if (typeof propertyKey === 'string' || typeof propertyKey === 'symbol') {
      if (descriptorOrIndex && 'value' in descriptorOrIndex && typeof descriptorOrIndex.value === 'function') {
        console.log(`Decorador de Método/Acessador: ${message} em ${String(propertyKey)}`);
      } else {
        console.log(`Decorador de Propriedade: ${message} em ${String(propertyKey)}`);
      }
    } else {
      console.log(`Decorador de Classe: ${message} em ${target.name}`);
    }
    return descriptorOrIndex; // Retorna o descritor para método/acessador, undefined para outros
  };
}

@log("Decorador de Classe D")
@log("Decorador de Classe C")
class MyDecoratedClass {
  @log("Propriedade Estática A")
  static staticProp: string = "";

  @log("Propriedade de Instância B")
  instanceProp: number = 0;

  @log("Método D")
  @log("Método C")
  myMethod(
    @log("Parâmetro Z") paramZ: string,
    @log("Parâmetro Y") paramY: number
  ) {
    console.log("Método myMethod executado.");
  }

  @log("Getter/Setter F")
  get myAccessor() {
    return "";
  }

  set myAccessor(value: string) {
    //...
  }

  constructor() {
    console.log("Construtor executado.");
  }
}

new MyDecoratedClass();
// Chama o método para acionar o decorador do método
new MyDecoratedClass().myMethod("hello", 123);

/* Ordem de Saída Prevista (aproximada, dependendo da versão específica do TypeScript e compilação):
Decorador de Parâmetro: Parâmetro Y no parâmetro #1 de myMethod
Decorador de Parâmetro: Parâmetro Z no parâmetro #0 de myMethod
Decorador de Propriedade: Propriedade Estática A em staticProp
Decorador de Propriedade: Propriedade de Instância B em instanceProp
Decorador de Método/Acessador: Getter/Setter F em myAccessor
Decorador de Método/Acessador: Método C em myMethod
Decorador de Método/Acessador: Método D em myMethod
Decorador de Classe: Decorador de Classe C em MyDecoratedClass
Decorador de Classe: Decorador de Classe D em MyDecoratedClass
Construtor executado.
Método myMethod executado.
*/
            

              
                Copy
              
            
          

            import "reflect-metadata"; // Essencial para emitDecoratorMetadata

const INJECTABLE_METADATA_KEY = Symbol("injectable");
const INJECT_METADATA_KEY = Symbol("inject");

function Injectable() {
  return function (target: Function) {
    Reflect.defineMetadata(INJECTABLE_METADATA_KEY, true, target);
  };
}

function Inject(token: any) {
  return function (target: Object, propertyKey: string | symbol, parameterIndex: number) {
    const existingInjections: any[] = Reflect.getOwnMetadata(INJECT_METADATA_KEY, target, propertyKey) || [];
    existingInjections[parameterIndex] = token;
    Reflect.defineMetadata(INJECT_METADATA_KEY, existingInjections, target, propertyKey);
  };
}

class Container {
  private static instances = new Map<any, any>();

  static resolve<T>(target: { new (...args: any[]): T }): T {
    if (Container.instances.has(target)) {
      return Container.instances.get(target);
    }

    const isInjectable = Reflect.getMetadata(INJECTABLE_METADATA_KEY, target);
    if (!isInjectable) {
      throw new Error(`Classe ${target.name} não está marcada como @Injectable.`);
    }

    // Obtém os tipos de parâmetros do construtor (requer emitDecoratorMetadata)
    const paramTypes: any[] = Reflect.getMetadata("design:paramtypes", target) || [];
    const explicitInjections: any[] = Reflect.getMetadata(INJECT_METADATA_KEY, target) || [];

    const dependencies = paramTypes.map((paramType, index) => {
      // Usa o token @Inject explícito se fornecido, senão infere o tipo
      const token = explicitInjections[index] || paramType;
      if (token === undefined) {
        throw new Error(`Não é possível resolver o parâmetro no índice ${index} para ${target.name}. Pode ser uma dependência circular ou um tipo primitivo sem @Inject explícito.`);
      }
      return Container.resolve(token);
    });

    const instance = new target(...dependencies);
    Container.instances.set(target, instance);
    return instance;
  }
}

// Define os serviços
@Injectable()
class DatabaseService {
  connect() {
    console.log("Conectando ao banco de dados...");
    return "Conexão DB";
  }
}

@Injectable()
class AuthService {
  private db: DatabaseService;

  constructor(db: DatabaseService) {
    this.db = db;
  }

  login() {
    console.log(`AuthService: Autenticando usando ${this.db.connect()}`);
    return "Usuário logado";
  }
}

@Injectable()
class UserService {
  private authService: AuthService;
  private dbService: DatabaseService; // Exemplo de injeção via propriedade usando um decorador customizado ou recurso do framework

  constructor(@Inject(AuthService) authService: AuthService,
              @Inject(DatabaseService) dbService: DatabaseService) {
    this.authService = authService;
    this.dbService = dbService;
  }

  getUserProfile() {
    this.authService.login();
    this.dbService.connect();
    console.log("UserService: Buscando perfil do usuário...");
    return { id: 1, name: "Usuário Global" };
  }
}

// Resolve o serviço principal
console.log("--- Resolvendo UserService ---");
const userService = Container.resolve(UserService);
console.log(userService.getUserProfile());

console.log("\n--- Resolvendo AuthService (deve ser cacheado) ---");
const authService = Container.resolve(AuthService);
authService.login();
            

              
                Copy
              
            
          

            function LogMethod(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const originalMethod = descriptor.value;
  descriptor.value = function (...args: any[]) {
    console.log(`[LOG AOP] Entrando no método: ${String(propertyKey)} com args:`, args);
    try {
      const result = originalMethod.apply(this, args);
      console.log(`[LOG AOP] Saindo do método: ${String(propertyKey)} com resultado:`, result);
      return result;
    } catch (error: any) {
      console.error(`[LOG AOP] Erro no método ${String(propertyKey)}:`, error.message);
      throw error;
    }
  };
  return descriptor;
}

class PaymentProcessor {
  @LogMethod
  processPayment(amount: number, currency: string) {
    if (amount <= 0) {
      throw new Error("O valor do pagamento deve ser positivo.");
    }
    console.log(`Processando pagamento de ${amount} ${currency}...`);
    return `Pagamento de ${amount} ${currency} processado com sucesso.`;
  }

  @LogMethod
  refundPayment(transactionId: string) {
    console.log(`Reembolsando pagamento para ID de transação: ${transactionId}...`);
    return `Reembolso iniciado para ${transactionId}.`;
  }
}

const processor = new PaymentProcessor();
processor.processPayment(100, "USD");
try {
  processor.processPayment(-50, "EUR");
} catch (error: any) {
  console.error("Erro capturado:", error.message);
}
            

              
                Copy
              
            
          

            interface FieldValidationRule {
  property: string | symbol;
  validator: (value: any) => boolean;
  message: string;
}

const fieldValidationRules = new Map<Function, FieldValidationRule[]>();

function addValidationRule(target: Object, propertyKey: string | symbol, validator: (value: any) => boolean, message: string) {
  const rules = fieldValidationRules.get(target.constructor) || [];
  rules.push({ property: propertyKey, validator, message });
  fieldValidationRules.set(target.constructor, rules);
}

function IsPositive(target: Object, propertyKey: string | symbol) {
  addValidationRule(target, propertyKey, (value: number) => value > 0, `${String(propertyKey)} deve ser um número positivo.`);
}

function MaxLength(maxLength: number) {
  return function (target: Object, propertyKey: string | symbol) {
    addValidationRule(target, propertyKey, (value: string) => value.length <= maxLength, `${String(propertyKey)} deve ter no máximo ${maxLength} caracteres.`);
  };
}

class Product {
  @MaxLength(50)
  name: string;

  @IsPositive
  price: number;

  constructor(name: string, price: number) {
    this.name = name;
    this.price = price;
  }

  static validate(instance: any): string[] {
    const errors: string[] = [];
    const rules = fieldValidationRules.get(instance.constructor) || [];
    for (const rule of rules) {
      if (!rule.validator(instance[rule.property])) {
        errors.push(rule.message);
      }
    }
    return errors;
  }
}

const product1 = new Product("Laptop", 1200);
console.log("Erros do Produto 1:", Product.validate(product1)); // []

const product2 = new Product("Nome de produto muito longo que excede o limite de cinquenta caracteres para fins de teste", 50);
console.log("Erros do Produto 2:", Product.validate(product2)); // ["name deve ter no máximo 50 caracteres."]

const product3 = new Product("Livro", -10);
console.log("Erros do Produto 3:", Product.validate(product3)); // ["price deve ser um número positivo."]
            

              
                Copy
              
            
          

            // Um decorador que garante que um método seja logado e também exija roles de admin
function AdminAndLoggedMethod() {
  return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
    // Aplica Authorization primeiro (interno)
    Authorization(["admin"])(target, propertyKey, descriptor);
    // Em seguida, aplica LogCall (externo)
    LogCall(target, propertyKey, descriptor);

    return descriptor; // Retorna o descritor modificado
  };
}

class AdminPanel {
  @AdminAndLoggedMethod()
  deleteUserAccount(userId: string) {
    console.log(`Excluindo conta de usuário: ${userId}`);
    return `Usuário ${userId} excluído.`;
  }
}

const adminPanel = new AdminPanel();
adminPanel.deleteUserAccount("user007");
/* Saída Esperada (assumindo role de admin):
[AUTH] Acesso concedido para deleteUserAccount
[LOG] Chamando deleteUserAccount com args: [ 'user007' ]
Excluindo conta de usuário: user007
[LOG] Método deleteUserAccount retornou: Usuário user007 excluído.
*/
            

              
                Copy
              
            
          

            function ApplyMixins(constructors: Function[]) {
  return function (derivedConstructor: Function) {
    constructors.forEach(baseConstructor => {
      Object.getOwnPropertyNames(baseConstructor.prototype).forEach(name => {
        Object.defineProperty(
          derivedConstructor.prototype,
          name,
          Object.getOwnPropertyDescriptor(baseConstructor.prototype, name) || Object.create(null)
        );
      });
    });
  };
}

class Disposable {
  isDisposed: boolean = false;
  dispose() {
    this.isDisposed = true;
    console.log("Objeto descartado.");
  }
}

class Loggable {
  log(message: string) {
    console.log(`[Loggable] ${message}`);
  }
}

@ApplyMixins([Disposable, Loggable])
class MyResource implements Disposable, Loggable {
  // Essas propriedades/métodos são injetados pelo decorador
  isDisposed!: boolean;
  dispose!: () => void;
  log!: (message: string) => void;

  constructor(public name: string) {
    this.log(`Recurso ${this.name} criado.`);
  }

  cleanUp() {
    this.dispose();
    this.log(`Recurso ${this.name} limpo.`);
  }
}

const resource = new MyResource("NetworkConnection");
console.log(`Está descartado: ${resource.isDisposed}`);
resource.cleanUp();
console.log(`Está descartado: ${resource.isDisposed}`);
            

              
                Copy